home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / adulate.zip / ADULATE.DOC next >
Text File  |  1990-06-30  |  5KB  |  114 lines
  1.     ADULATE.EXE - the program that panders to your ego! 
  2.  
  3.     Author .... : Larry T Cobb 
  4.  
  5.     Created ... : 13:48 Fri 10 Mar 1989 
  6.     Last Update : 5/24/89 at 14:35:00 
  7.     Release ... : 1.8 
  8.  
  9.  
  10.     Executive Summary
  11.  
  12.     In this rat-race of a world it good to have someone (or even something) 
  13.     that you can rely on for a bit of obsequious grovelling.  So, if you 
  14.     haven't got any sycophantic minions, you can use this program to force 
  15.     your poor, unsuspecting PC to bolster your ego.  Call it from your 
  16.     AUTOEXEC.BAT for a cringing start to the day's computing, or type 
  17.     "ADULATE 20" for a boost during a really bad session.  You'll soon be 
  18.     on top of the world again! 
  19.  
  20.  
  21.     Using the Random Adulation Program: 
  22.     
  23.     Words from four lists of adulating words or phrases are combined 
  24.     randomly to form a composite adulation.  The C standard random number 
  25.     generator is used to select from the lists.  It is seeded differently 
  26.     each run using the system time, so each run will produce an 
  27.     unpredictable phrase or set of phrases.  
  28.     
  29.                                                                        
  30.     Usage:      ADULATE [-n or /n] [count] 
  31.      
  32.         If the option '-n' or '/n' is present, the phrase begins with the
  33.         word "o" (lower case) and is not terminated with a newline.  
  34.      
  35.         Otherwise it begins with upper case "O" and is terminated with a 
  36.         full stop and newline.  (These are the defaults where no '.fmt' 
  37.         file is in use - see below.)  
  38.                                                                               
  39.     The count value is a decimal number of phrases to be produced.  A 
  40.     default count of 1 is used if the count parameter is not present or 
  41.     evaluates to zero or a negative number.  
  42.                                                                               
  43.     Arbitrary formats can be specified at run time by including them in a 
  44.     text file having the name 'adulate.fmt'.  To be used, this must be in 
  45.     the current default directory.  Each line of the file represents an 
  46.     alternative format for the output phrases.  These are read into two 
  47.     lists in memory, one for formats for use in normal mode, and one for 
  48.     formats for the '-n' or '/n' option. If these lists have more than one 
  49.     entry, a format for each adulation is selected at random from the 
  50.     appropriate list.  
  51.      
  52.     If the format file contains no entries for a particular list, the 
  53.     default format for that mode is used.  Otherwise the default formats 
  54.     are discarded when a format file is in use.  
  55.      
  56.  
  57.     The format of each line is: 
  58.                                                                               
  59.     <format_mode><format_string>    
  60.         
  61.     where  <format_mode> is the single character 'F' or 'f', signifying 
  62.     that the format specification is to be used in normal mode or with the 
  63.     'n' option respectively.  If <format_mode> is omitted, it is taken to 
  64.     be 'F'.  
  65.      
  66.     <format_string> is the wanted format specified as for 'printf'.  The 
  67.     special character specifications '\n', '\t', '\b', '\r','\f' and '\\' 
  68.     are recognised, (standard C notation).  Single and double quote 
  69.     characters may be included without being escaped since they are not 
  70.     used to delimit the format string.  
  71.      
  72.     Note: 
  73.      
  74.         1) The format string should contain exactly one '%s' specification 
  75.            for each of the component word lists, or else operation is 
  76.            undefined. No other field specifiers should be included.  
  77.      
  78.         2) If the <format_mode> letter is omitted, the <format_string> 
  79.            should not begin with 'F' or 'f' or else the first letter of the 
  80.            string will be taken to be the <format_mode> and stripped from 
  81.            the <format_string>.  
  82.      
  83.         3) If the format file is created using a word processor, make sure
  84.            that no formatting characters are left in the file. 
  85.     
  86.           
  87.     Examples: 
  88.                                                                               
  89.         Format: FWhat is your desire, %s %s of the %s %s?\n 
  90.         Phrase: What is your desire, unique wonder of the snappy retort?  
  91.                                                                               
  92.         Format: Hail, %s %s of the %s %s!\n 
  93.         Phrase: Hail, leafy keeper of the mighty East!
  94.      
  95.         Format: fsalutations, %s %s of the %s %s 
  96.         Phrase: salutations, valiant leader of the unfamiliar palindrome 
  97.                 [N.B. this last phrase would have no terminating newline] 
  98.                                                                               
  99.      
  100.                                                                               
  101.     
  102.  
  103.  
  104.     Copyright Larry T Cobb, 1989
  105.     CompuServe id: 100016,421
  106.      
  107.  
  108.     You are free to copy and distribute this program provided that no 
  109.     charge, of any kind, is made for it, the disk, or distribution.  Also, 
  110.     this file must be included with the program and the whole must be 
  111.     distributed unaltered.  Any other arrangement requires the author's 
  112.     written permission. 
  113.  
  114.